home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-dns-resolver-mib-01.txt < prev    next >
Text File  |  1993-07-19  |  60KB  |  2,065 lines
  1.  
  2.  
  3.  
  4.           draft                  DNS Resolver MIB                July 93
  5.  
  6.  
  7.                            DNS Resolver MIB Extensions
  8.  
  9.                                    8-July-1993
  10.  
  11.  
  12.                                 DNS Working Group
  13.  
  14.                                    Rob Austein
  15.                          Epilogue Technology Corporation
  16.                                  sra@epilogue.com
  17.  
  18.  
  19.                                    Jon Saperia
  20.                           Digital Equipment Corporation
  21.                                saperia@tay.dec.com
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                                Status of this Memo
  28.  
  29.  
  30.           This document is an Internet Draft.  Internet Drafts are
  31.           working documents of the Internet Engineering Task Force
  32.           (IETF), its Areas, and its Working Groups.  Note that other
  33.           groups may also distribute working documents as Internet
  34.           Drafts.
  35.  
  36.           Internet Drafts are valid for a maximum of six months and may
  37.           be updated, replaced, or obsoleted by other documents at any
  38.           time.  It is inappropriate to use Internet Drafts as reference
  39.           material or to cite them other than as a "work in progress".
  40.  
  41.           Please check the id-abstracts.txt listing contained in the
  42.           internet-drafts Shadow Directories on the nic.ddn.mil,
  43.           nnsc.nsf.net, nic.nordu.net, ftp.nisc.sri.com, or
  44.           munnari.oz.au to learn the current status of any Internet
  45.           Draft.
  46.  
  47.           This document will be submitted to the Internet Architecture
  48.           Board as a Proposed Standard.  This document defines and
  49.           experimental extension to the SNMP MIB.  Upon publication as a
  50.           Proposed Standard, a new MIB number will be assigned.  This is
  51.           a working document only, it should neither be cited nor quoted
  52.  
  53.  
  54.  
  55.  
  56.  
  57.           Expires January 8, 1994                               [Page 1]
  58.  
  59.  
  60.  
  61.  
  62.  
  63.           draft                  DNS Resolver MIB                July 93
  64.  
  65.  
  66.           in a formal document.
  67.  
  68.           This document will expire before 8 January 1994.
  69.  
  70.           Distribution of this document is unlimited.
  71.  
  72.           Please send comments to the authors.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.           Expires January 8, 1994                               [Page 2]
  117.  
  118.  
  119.  
  120.  
  121.  
  122.           draft                  DNS Resolver MIB                July 93
  123.  
  124.  
  125.           1.  Introduction
  126.  
  127.           This memo defines a set of extensions that have been created
  128.           for the Internet MIB which instrument DNS Resolver Functions
  129.           and was produced by the DNS working group.  This memo does not
  130.           specify a standard for the Internet community.
  131.  
  132.           With the adoption of The Simple Network Management Protocol
  133.           (RFC 1157), the Management Information Base for network
  134.           management of TCP/IP-based internets (RFC 1213), and the
  135.           Structure of Management Information (RFC 1155) by the
  136.           Internet, and a large number of vendor implementations of
  137.           these standards in commercially available products, it became
  138.           possible to provide a higher level of effective network
  139.           management in TCP/IP-based internets than previously
  140.           available.  With the growth in the use of these standards, it
  141.           has become possible to consider the management of other
  142.           elements of the infrastructure beyond the basic TCP/IP
  143.           protocols.  A key element of the TCP/IP infrastructure is the
  144.           DNS.
  145.  
  146.           Up to this point there has been no mechanism to integrate the
  147.           management of the DNS with SNMP-based managers.  This memo
  148.           provides the mechanisms by which IP-based management stations
  149.           can effectively manage DNS resolver software in an integrated
  150.           fashion through the use of the standard Internet SMI, MIB and
  151.           Simple Network Management Protocol.
  152.  
  153.           New DNS MIB objects have been defined to be used in
  154.           conjunction with the Internet MIB to allow access and control
  155.           of the DNS resolver software via SNMP by the Internet
  156.           community.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.           Expires January 8, 1994                               [Page 3]
  176.  
  177.  
  178.  
  179.  
  180.  
  181.           draft                  DNS Resolver MIB                July 93
  182.  
  183.  
  184.           2.  The Network Management Framework
  185.  
  186.           The Internet-standard Network Management Framework consists of
  187.           four components.  They are:
  188.  
  189.           o    RFC 1155 which defines the SMI, the mechanisms used for
  190.                describing and naming objects for the purpose of
  191.                management.
  192.  
  193.           o    RFC 1212 defines a more concise description mechanism,
  194.                which is wholly consistent with the SMI.
  195.  
  196.           o    RFC 1213 defines MIB-II, the core set of managed objects
  197.                for the Internet suite of protocols.
  198.  
  199.           o    RFC 1157 which defines the SNMP, the protocol used for
  200.                network access to managed objects.
  201.  
  202.           The Framework permits new objects to be defined for the
  203.           purpose of experimentation and evaluation.
  204.  
  205.  
  206.           2.1.  Object Definitions
  207.  
  208.           Managed objects are accessed via a virtual information store,
  209.           termed the Management Information Base or MIB.  Objects in the
  210.           MIB are defined using the subset of Abstract Syntax Notation
  211.           One (ASN.1) defined in the SMI.  In particular, each object
  212.           object type is named by an OBJECT IDENTIFIER, an
  213.           administratively assigned name.  The object type together with
  214.           an object instance serves to uniquely identify a specific
  215.           instantiation of the object.  For human convenience, we often
  216.           use a textual string, termed the descriptor, to refer to the
  217.           object type.
  218.  
  219.  
  220.           2.2.  Format of Definitions
  221.  
  222.           Section 5 contains the specification of all object types
  223.           contained in this MIB module.  The object types are defined
  224.           using the conventions defined in the SMI, as amended by the
  225.           extensions specified in [5,6].
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.           Expires January 8, 1994                               [Page 4]
  235.  
  236.  
  237.  
  238.  
  239.  
  240.           draft                  DNS Resolver MIB                July 93
  241.  
  242.  
  243.           3.  Overview
  244.  
  245.           In theory, the DNS world is pretty simple.  There are two
  246.           kinds of entities: resolvers and name servers.  Resolvers ask
  247.           questions.  Name servers answer them.  The real world,
  248.           however, is not so simple.  Implementors have made widely
  249.           differing choices about how to divide DNS functions between
  250.           resolvers and servers.  They have also constructed various
  251.           sorts of exotic hybrids.  The most difficult task in defining
  252.           this MIB was to accommodate this wide range of entities
  253.           without having to come up with a separate MIB for each.
  254.  
  255.           We divided up the various DNS functions into two, non-
  256.           overlapping classes, called 'resolver functions' and 'name
  257.           server functions'.  A DNS entity that performs what we define
  258.           as resolver functions contains a resolver, and therefore must
  259.           implement the MIB groups required of all resolvers which are
  260.           defined in this module.  Some resolvers also implement
  261.           'optional' functions such as a cache.  In this example, they
  262.           will also implement the cache group contained in this MIB.  A
  263.           DNS entity which implements name server functions is
  264.           considered to be a name server, and must implement the MIB
  265.           groups required for name servers which are defined in a
  266.           separate module.  If the same piece of software performs both
  267.           resolver and server functions, we imagine that it contains
  268.           both a resolver and a server and would thus implement both the
  269.           DNS Server and DNS Resolver MIBs.
  270.  
  271.           In our model, a resolver is a program (or piece thereof) which
  272.           obtains resource records from servers.  Normally it does so at
  273.           the behest of an application, but may also do so as part of
  274.           its own operation.  A resolver sends DNS protocol queries and
  275.           receives DNS protocol replies.  A resolver neither receives
  276.           queries nor sends replies.  A full service resolver is one
  277.           that knows how to resolve queries: it obtains the needed
  278.           resource records by contacting a server authoritative for the
  279.           records desired.  A stub resolver does not know how to resolve
  280.           queries: it sends all queries to a local name server, setting
  281.           the recursion desired flag to indicate that it hopes that the
  282.           name server will be willing resolve the query.  A resolver may
  283.           (optionally) have a cache for remembering previously acquired
  284.           resource records.  It may also have a negative cache for
  285.           remembering names or data that have been determined not to
  286.           exist.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.           Expires January 8, 1994                               [Page 5]
  294.  
  295.  
  296.  
  297.  
  298.  
  299.           draft                  DNS Resolver MIB                July 93
  300.  
  301.  
  302.           A name server is a program (or piece thereof) that provides
  303.           resource records to resolvers.  All references in this
  304.           document to 'a name server' imply 'the name server's role'.
  305.           (In some cases the name server's role and the resolver's role
  306.           might be combined into a single program.)  A name server
  307.           receives DNS protocol queries and sends DNS protocol replies.
  308.           A name server neither sends queries nor receives replies. As a
  309.           consequence, name servers do not have caches.  Normally, a
  310.           name server would expect to receive only those queries to
  311.           which it could respond with authoritative information.
  312.           However, if a name server receives a query that it cannot
  313.           respond to with purely authoritative information, it may
  314.           choose to try to obtain the necessary additional information
  315.           from a resolver which may or may not be a separate process.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.           Expires January 8, 1994                               [Page 6]
  353.  
  354.  
  355.  
  356.  
  357.  
  358.           draft                  DNS Resolver MIB                July 93
  359.  
  360.  
  361.           4.  Selected Objects
  362.  
  363.           Many of the objects included in this memo have been created
  364.           from information contained in the DNS specification.  The DNS
  365.           specification is found in Domain Names - Concepts and
  366.           Facilities (RFC 1034) and Domain Names - Implementation and
  367.           Specification (RFC 1035), as amended and clarified by
  368.           Requirements for Internet Hosts - Application and Support (RFC
  369.           1123).  Additional usage information is found in the Domain
  370.           Administrators Guide (RFC 1032), and the Domain Administrators
  371.           Operations Guide (RFC 1033).  Other objects have been created
  372.           based on experience with existing DNS management tools,
  373.           expected operational need, and the statistics generated by
  374.           existing DNS implementations.  These objects have been ordered
  375.           into groups as follows:
  376.  
  377.               Resolver Configuration Group
  378.               Resolver Counter Group
  379.               Resolver Cache Group
  380.               Resolver Negative Cache Group
  381.               Resolver Statistics Group
  382.               Resolver Optional Counter Group
  383.  
  384.           Some of the objects defined in this memo have been created
  385.           from information contained in existing configuration files
  386.           used by many DNS implementations. This information has been
  387.           converted into a standard form using the Internet Standard SMI
  388.           defined in RFC 1155.  The object descriptors used in this MIB
  389.           have been created from a variety of sources.  For the most
  390.           part, the descriptions are influenced by by the DNS related
  391.           RFCs noted above.  For example, the descriptors for counters
  392.           used for the various types of queries of DNS records are
  393.           influenced by the definitions used for the various record
  394.           types found in Domain Names - Implementation and Specification
  395.           RFC 1035.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.           Expires January 8, 1994                               [Page 7]
  412.  
  413.  
  414.  
  415.  
  416.  
  417.           draft                  DNS Resolver MIB                July 93
  418.  
  419.  
  420.           5.  Textual Conventions
  421.  
  422.           Several datatypes have been introduced as a textual
  423.           conventions in the DNS Server MIB document and have been
  424.           imported into this MIB Module.  These additions will
  425.           facilitate the common understanding of information used by the
  426.           DNS.  No changes to the SMI or the SNMP are necessary to
  427.           support these conventions which are described in the
  428.           Definitions section.
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.           Expires January 8, 1994                               [Page 8]
  471.  
  472.  
  473.  
  474.  
  475.  
  476.           draft                  DNS Resolver MIB                July 93
  477.  
  478.  
  479.           6.  Definitions
  480.  
  481.                RFCxxxx-dnsResMIB
  482.  
  483.                DEFINITIONS ::= BEGIN
  484.  
  485.                IMPORTS
  486.                    IpAddress, Counter,
  487.                    experimental
  488.                      FROM RFC1155-SMI
  489.                    DisplayString
  490.                      FROM RFC1213-MIB
  491.                    OBJECT-TYPE
  492.                      FROM RFC1212
  493.                    dns, DnsDate, DnsName, DnsClass,
  494.                    DnsType, DnsQClass, DnsQType, DnsTime,
  495.                    DnsValid, DnsOpCode, DnsRespCode
  496.                      FROM RFC-xxxx;
  497.  
  498.           -- DNS Resolver MIB
  499.  
  500.                dnsRes          OBJECT IDENTIFIER ::= { dns 2 }
  501.  
  502.           -- groups in the dns resolver mib
  503.  
  504.                dnsResConfig          OBJECT IDENTIFIER ::= { dnsRes 1 }
  505.                dnsResCounter         OBJECT IDENTIFIER ::= { dnsRes 2 }
  506.                dnsResCache           OBJECT IDENTIFIER ::= { dnsRes 3 }
  507.                dnsResNCache          OBJECT IDENTIFIER ::= { dnsRes 4 }
  508.                dnsResStats           OBJECT IDENTIFIER ::= { dnsRes 5 }
  509.                dnsResOptCounter      OBJECT IDENTIFIER ::= { dnsRes 6 }
  510.  
  511.           -- Resolver Configuration Group
  512.  
  513.           -- The implementation of the Resolver Configuration group is
  514.           -- mandatory for all systems which implement any resolver
  515.           -- software functions.
  516.  
  517.           dnsResConfigImplementIdent OBJECT-TYPE
  518.                SYNTAX  DisplayString
  519.                ACCESS  read-only
  520.                STATUS  mandatory
  521.                DESCRIPTION
  522.                        "The implementation identification string for
  523.                        the resolver software in use on the system,
  524.  
  525.  
  526.  
  527.  
  528.  
  529.           Expires January 8, 1994                               [Page 9]
  530.  
  531.  
  532.  
  533.  
  534.  
  535.           draft                  DNS Resolver MIB                July 93
  536.  
  537.  
  538.                        for example; RES2.1"
  539.                ::= { dnsResConfig 1 }
  540.  
  541.           dnsResConfigService OBJECT-TYPE
  542.                SYNTAX  INTEGER {
  543.                     recursive-only (1),
  544.                     iterative-only (2),
  545.                     recursive-and-iterative (3)
  546.                }
  547.                ACCESS  read-only
  548.                STATUS  mandatory
  549.                DESCRIPTION
  550.                     "Kind of DNS resolution service provided.
  551.                     RECURSIVE-ONLY indicates a stub resolver.
  552.  
  553.                     ITERATIVE-ONLY indicates a normal full service
  554.                     resolver.
  555.  
  556.                     RECURSIVE-AND-ITERATIVE indicates a full service
  557.                     resolver which performs a mix of recursive and
  558.                     iterative queries."
  559.                ::= { dnsResConfig 2 }
  560.  
  561.           dnsResConfigMaxCnames OBJECT-TYPE
  562.                SYNTAX  INTEGER
  563.                ACCESS  read-write
  564.                STATUS  mandatory
  565.                DESCRIPTION
  566.                     "Limit on how many CNAMEs the resolver should
  567.                     allow before deciding that there's a CNAME loop.
  568.                     Zero means that resolver has no explicit CNAME
  569.                     limit.  See RFC 1035 section 7.1 for more
  570.                     information on circular CNAME references."
  571.                ::= { dnsResConfig 3 }
  572.  
  573.           -- DNS Resolver Seat Belt Table
  574.  
  575.           dnsResConfigSeatBeltTable OBJECT-TYPE
  576.                SYNTAX  SEQUENCE OF DnsResConfigSeatBeltEntry
  577.                ACCESS  not-accessible
  578.                STATUS  mandatory
  579.                DESCRIPTION
  580.                     "Table of safety belt information used by the
  581.                     resolver when it hasn't got any better idea of
  582.                     where to send a query, such as when the resolver
  583.  
  584.  
  585.  
  586.  
  587.  
  588.           Expires January 8, 1994                              [Page 10]
  589.  
  590.  
  591.  
  592.  
  593.  
  594.           draft                  DNS Resolver MIB                July 93
  595.  
  596.  
  597.                     is booting or is a stub resolver."
  598.                ::= { dnsResConfig 4 }
  599.  
  600.           dnsResConfigSeatBeltEntry OBJECT-TYPE
  601.                SYNTAX  DnsResConfigSeatBeltEntry
  602.                ACCESS  not-accessible
  603.                STATUS  mandatory
  604.                DESCRIPTION
  605.                        "An entry in the resolver's seatbelt table."
  606.                INDEX { dnsResConfigSeatBeltAddr,
  607.                        dnsResConfigSeatBeltSubTree,
  608.                        dnsResConfigSeatBeltClass }
  609.                ::= { dnsResConfigSeatBeltTable 1 }
  610.  
  611.           DnsResConfigSeatBeltEntry ::=
  612.                SEQUENCE {
  613.                   dnsResConfigSeatBeltAddr
  614.                       IpAddress,
  615.                   dnsResConfigSeatBeltName
  616.                       DnsName,
  617.                   dnsResConfigSeatBeltRecursion
  618.                       INTEGER,
  619.                   dnsResConfigSeatBeltPref
  620.                       INTEGER,
  621.                   dnsResConfigSeatBeltSubTree
  622.                       DnsName,
  623.                   dnsResConfigSeatBeltClass
  624.                       DnsClass,
  625.                   dnsResConfigSeatBeltFile
  626.                       OCTET STRING,
  627.                   dnsResConfigSeatBeltDate
  628.                       DnsDate,
  629.                   dnsResConfigSeatBeltValid
  630.                       DnsValid
  631.                }
  632.           dnsResConfigSeatBeltAddr OBJECT-TYPE
  633.                SYNTAX  IpAddress
  634.                ACCESS  read-only
  635.                STATUS  mandatory
  636.                DESCRIPTION
  637.                        "The IP address of the SeatBelt name server
  638.                        identified by this row of the table."
  639.                ::= { dnsResConfigSeatBeltEntry 1 }
  640.  
  641.           dnsResConfigSeatBeltName OBJECT-TYPE
  642.  
  643.  
  644.  
  645.  
  646.  
  647.           Expires January 8, 1994                              [Page 11]
  648.  
  649.  
  650.  
  651.  
  652.  
  653.           draft                  DNS Resolver MIB                July 93
  654.  
  655.  
  656.                SYNTAX  DnsName  --  OCTET STRING
  657.                ACCESS  read-only
  658.                STATUS  mandatory
  659.                DESCRIPTION
  660.                        "The DNS name of a SeatBelt nameserver
  661.                        identified by this row of the table.  The NULL
  662.                        string indicates that the name is not known by
  663.                        the resolver."
  664.                ::= { dnsResConfigSeatBeltEntry 2 }
  665.  
  666.           dnsResConfigSeatBeltRecursion OBJECT-TYPE
  667.                SYNTAX  INTEGER {
  668.                     iterative (1),
  669.                     recursive (2),
  670.                     recursive-and-iterative (3)
  671.                }
  672.                ACCESS  read-only
  673.                STATUS  mandatory
  674.                DESCRIPTION
  675.                        "Kind of queries resolver will be sending to
  676.                        the server.
  677.  
  678.                        ITERATIVE indicates that resolver will be
  679.                        directing iterative queries to this name
  680.                        server (RD bit turned off).
  681.  
  682.                        RECURSIVE indicates that resolver will be
  683.                        directing recursive queries to this name
  684.                        server (RD bit turned on).
  685.  
  686.                        RECURSIVE-AND-ITERATIVE indicates that the
  687.                        resolver will be directing both recursive and
  688.                        iterative queries to the server identified in
  689.                        this row of the table."
  690.                ::= { dnsResConfigSeatBeltEntry 3 }
  691.  
  692.           dnsResConfigSeatBeltPref OBJECT-TYPE
  693.                SYNTAX  INTEGER
  694.                ACCESS  read-only
  695.                STATUS  mandatory
  696.                DESCRIPTION
  697.                        "This value identifies the preference for the
  698.                        server identified in this row of the table.
  699.                        The lower the value, the more desirable the
  700.                        particular server is considered."
  701.  
  702.  
  703.  
  704.  
  705.  
  706.           Expires January 8, 1994                              [Page 12]
  707.  
  708.  
  709.  
  710.  
  711.  
  712.           draft                  DNS Resolver MIB                July 93
  713.  
  714.  
  715.                ::= { dnsResConfigSeatBeltEntry 4 }
  716.  
  717.           dnsResConfigSeatBeltSubTree OBJECT-TYPE
  718.                SYNTAX  DnsName  --  OCTET STRING
  719.                ACCESS  read-only
  720.                STATUS  mandatory
  721.                DESCRIPTION
  722.                        "Queries sent to the Seatbelt name server
  723.                        identified by this row of the table are
  724.                        limited to those for names in the name subtree
  725.                        identified by this variable.  If no such
  726.                        limitation applies, the value of this variable
  727.                        is the name of THE root domain."
  728.                ::= { dnsResConfigSeatBeltEntry 5 }
  729.  
  730.           dnsResConfigSeatBeltClass OBJECT-TYPE
  731.                SYNTAX  DnsClass -- INTEGER (0..65535)
  732.                ACCESS  read-only
  733.                STATUS  mandatory
  734.                DESCRIPTION
  735.                        "The class of DNS queries that will be sent to
  736.                        the server identified by this row of the
  737.                        table."
  738.                ::= { dnsResConfigSeatBeltEntry 6 }
  739.  
  740.           dnsResConfigSeatBeltFile OBJECT-TYPE
  741.                SYNTAX  OCTET STRING
  742.                ACCESS  read-only
  743.                STATUS  mandatory
  744.                DESCRIPTION
  745.                        "The name of the file from which the
  746.                        information in this row of the table was last
  747.                        initialized or updated. The value is the null
  748.                        string if information came from a source other
  749.                        than a configuration file."
  750.                ::= { dnsResConfigSeatBeltEntry 7 }
  751.  
  752.           dnsResConfigSeatBeltDate OBJECT-TYPE
  753.                SYNTAX  DnsDate -- DisplayString
  754.                ACCESS  read-only
  755.                STATUS  mandatory
  756.                DESCRIPTION
  757.                        "The date and time that the file named by the
  758.                        dnsResConfigSeatBeltFile variable for this row
  759.                        had last been updated at the time that this
  760.  
  761.  
  762.  
  763.  
  764.  
  765.           Expires January 8, 1994                              [Page 13]
  766.  
  767.  
  768.  
  769.  
  770.  
  771.           draft                  DNS Resolver MIB                July 93
  772.  
  773.  
  774.                        row was last initialized or updated.  The
  775.                        value is the null string if unknown or not
  776.                        applicable because the
  777.                        dnsResConfigSeatBeltFile variable is the null
  778.                        string."
  779.                ::= { dnsResConfigSeatBeltEntry 8 }
  780.  
  781.           dnsResConfigSeatBeltValid OBJECT-TYPE
  782.                SYNTAX  DnsValid
  783.                ACCESS  read-write
  784.                STATUS  mandatory
  785.                DESCRIPTION
  786.                        "Setting this variable to CLEAR deletes this
  787.                        SeatBelt server."
  788.                ::= { dnsResConfigSeatBeltEntry 9 }
  789.  
  790.           -- Resolver Counters Group
  791.  
  792.           -- The implementation of the Resolver Counters Group is
  793.           -- mandatory for all systems which implement resolver
  794.           -- functions.
  795.  
  796.           dnsResCounterUpTime OBJECT-TYPE
  797.                SYNTAX  DnsTime
  798.                ACCESS  read-only
  799.                STATUS  mandatory
  800.                DESCRIPTION
  801.                        "If the resolver has a persistent state, e.g.,
  802.                        a process; this value will be the time elapsed
  803.                        since it started.  For software that does not
  804.                        have persistence, this value will be 0."
  805.                ::= { dnsResCounter 1 }
  806.  
  807.           dnsResCounterResetTime OBJECT-TYPE
  808.                SYNTAX  DnsTime
  809.                ACCESS  read-only
  810.                STATUS  mandatory
  811.                DESCRIPTION
  812.                        "Elapsed time since cache was reloaded."
  813.               ::= { dnsResCounter 2 }
  814.  
  815.           -- Resolver Counter Table
  816.  
  817.           dnsResCounterTable OBJECT-TYPE
  818.                SYNTAX  SEQUENCE OF DnsResCounterTableEntry
  819.  
  820.  
  821.  
  822.  
  823.  
  824.           Expires January 8, 1994                              [Page 14]
  825.  
  826.  
  827.  
  828.  
  829.  
  830.           draft                  DNS Resolver MIB                July 93
  831.  
  832.  
  833.                ACCESS  not-accessible
  834.                STATUS  mandatory
  835.                DESCRIPTION
  836.                        "Table of the current count of resolver
  837.                        queries and answers."
  838.               ::= { dnsResCounter 3 }
  839.  
  840.           dnsResCounterTableEntry OBJECT-TYPE
  841.                SYNTAX  DnsResCounterTableEntry
  842.                ACCESS  not-accessible
  843.                STATUS  mandatory
  844.                DESCRIPTION
  845.                        "Entry in the resolver counter table.  Entries
  846.                        are indexed by dns OpCode."
  847.                INDEX { dnsResCounterOpCode }
  848.                ::= { dnsResCounterTable 1 }
  849.  
  850.           DnsResCounterTableEntry ::=
  851.                SEQUENCE {
  852.                    dnsResCounterOpCode
  853.                         DnsOpCode,
  854.                    dnsResCounterQueries
  855.                         Counter,
  856.                    dnsResCounterResponses
  857.                         Counter
  858.                }
  859.           dnsResCounterOpCode OBJECT-TYPE
  860.                SYNTAX  DnsOpCode -- INTEGER (0..15)
  861.                ACCESS  read-only
  862.                STATUS  mandatory
  863.                DESCRIPTION
  864.                        "The index to this table.  The OpCodes that
  865.                        have already been defined are found in
  866.                        RFC1035."
  867.                ::= { dnsResCounterTableEntry 1 }
  868.  
  869.           dnsResCounterQueries OBJECT-TYPE
  870.                SYNTAX  Counter
  871.                ACCESS  read-only
  872.                STATUS  mandatory
  873.                DESCRIPTION
  874.                        "Number of queries [total] that have sent out
  875.                        by the resolver since initialization for the
  876.                        OpCode which is the index to this row of the
  877.                        table."
  878.  
  879.  
  880.  
  881.  
  882.  
  883.           Expires January 8, 1994                              [Page 15]
  884.  
  885.  
  886.  
  887.  
  888.  
  889.           draft                  DNS Resolver MIB                July 93
  890.  
  891.  
  892.                ::= { dnsResCounterTableEntry 2 }
  893.  
  894.           dnsResCounterResponses OBJECT-TYPE
  895.                SYNTAX  Counter
  896.                ACCESS  read-only
  897.                STATUS  mandatory
  898.                DESCRIPTION
  899.                        "Number of responses [total] that have been
  900.                        received by the resolver since initialization
  901.                        for the OpCode which is the index to this row
  902.                        of the table."
  903.                ::= { dnsResCounterTableEntry 3 }
  904.  
  905.           -- Resolver Response Code Counter Table
  906.  
  907.           dnsResResponseTable OBJECT-TYPE
  908.                SYNTAX  SEQUENCE OF DnsResResponseTableEntry
  909.                ACCESS  not-accessible
  910.                STATUS  mandatory
  911.                DESCRIPTION
  912.                        "Table of the current count of responses to
  913.                        resolver queries."
  914.               ::= { dnsResCounter 4 }
  915.  
  916.           dnsResResponseTableEntry OBJECT-TYPE
  917.                SYNTAX  DnsResResponseTableEntry
  918.                ACCESS  not-accessible
  919.                STATUS  mandatory
  920.                DESCRIPTION
  921.                        "Entry in the resolver response table.
  922.                        Entries are indexed by DNS response code."
  923.                INDEX { dnsResResponseCode }
  924.                ::= { dnsResResponseTable 1 }
  925.  
  926.           DnsResResponseTableEntry ::=
  927.                SEQUENCE {
  928.                    dnsResResponseCode
  929.                         DnsRespCode,
  930.                    dnsResResponses
  931.                         Counter
  932.                }
  933.           dnsResResponseCode OBJECT-TYPE
  934.                SYNTAX  DnsRespCode -- INTEGER (0..15)
  935.                ACCESS  read-only
  936.                STATUS  mandatory
  937.  
  938.  
  939.  
  940.  
  941.  
  942.           Expires January 8, 1994                              [Page 16]
  943.  
  944.  
  945.  
  946.  
  947.  
  948.           draft                  DNS Resolver MIB                July 93
  949.  
  950.  
  951.                DESCRIPTION
  952.                        "The index to this table.  The Response Codes
  953.                        that have already been defined are found in
  954.                        RFC1035."
  955.                ::= { dnsResResponseTableEntry 1 }
  956.  
  957.           dnsResResponses OBJECT-TYPE
  958.                SYNTAX  Counter
  959.                ACCESS  read-only
  960.                STATUS  mandatory
  961.                DESCRIPTION
  962.                        "Number of responses the resolver has received
  963.                        for the response code value which identifies
  964.                        this row of the table."
  965.                ::= { dnsResResponseTableEntry 2 }
  966.  
  967.           -- Additional DNS Resolver Counter Objects
  968.  
  969.           dnsResCounterNonAuthDataResps OBJECT-TYPE
  970.                SYNTAX  Counter
  971.                ACCESS  read-only
  972.                STATUS  mandatory
  973.                DESCRIPTION
  974.                        "Number of requests made by the resolver for
  975.                        which a non-authoritative answer (cached data)
  976.                        was received."
  977.                ::= { dnsResCounter 5 }
  978.  
  979.           dnsResCounterNonAuthNoDataResps OBJECT-TYPE
  980.                SYNTAX  Counter
  981.                ACCESS  read-only
  982.                STATUS  mandatory
  983.                DESCRIPTION
  984.                        "Number of requests made by the resolver for
  985.                        which a non-authoritative answer - no such
  986.                        data response (empty answer) was received."
  987.                ::= { dnsResCounter 6 }
  988.  
  989.           dnsResCounterMartians OBJECT-TYPE
  990.                SYNTAX  Counter
  991.                ACCESS  read-only
  992.                STATUS  mandatory
  993.                DESCRIPTION
  994.                        "Number of responses received which were
  995.                        received from servers that the resolver does
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.           Expires January 8, 1994                              [Page 17]
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.           draft                  DNS Resolver MIB                July 93
  1008.  
  1009.  
  1010.                        not think it asked."
  1011.                ::= { dnsResCounter 7 }
  1012.  
  1013.           dnsResCounterRecdResponses OBJECT-TYPE
  1014.                SYNTAX  Counter
  1015.                ACCESS  read-only
  1016.                STATUS  mandatory
  1017.                DESCRIPTION
  1018.                        "Number of responses received to all queries."
  1019.                ::= { dnsResCounter 8 }
  1020.  
  1021.           dnsResCounterUnparseResps OBJECT-TYPE
  1022.                SYNTAX  Counter
  1023.                ACCESS  read-only
  1024.                STATUS  mandatory
  1025.                DESCRIPTION
  1026.                        "Number of responses received which were
  1027.                        unparseable."
  1028.                ::= { dnsResCounter 9 }
  1029.  
  1030.           dnsResCounterFallbacks OBJECT-TYPE
  1031.                SYNTAX  Counter
  1032.                ACCESS  read-only
  1033.                STATUS  mandatory
  1034.                DESCRIPTION
  1035.                        "Number of times the resolver had to fall back
  1036.                        to its seat belt information."
  1037.                ::= { dnsResCounter 10 }
  1038.  
  1039.           -- Resolver Cache Group
  1040.  
  1041.           -- The implementation of the Resolver Cache Group is mandatory
  1042.           -- for all systems which implement a cache.
  1043.  
  1044.           dnsResCacheStatus OBJECT-TYPE
  1045.                SYNTAX  INTEGER {
  1046.                     enabled (1),
  1047.                     disabled (2)
  1048.                }
  1049.                ACCESS  read-only
  1050.                STATUS  mandatory
  1051.                DESCRIPTION
  1052.                        "Status of the resolver's cache.
  1053.                        ENABLED means that the use of the cache is
  1054.                        allowed.
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.           Expires January 8, 1994                              [Page 18]
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.           draft                  DNS Resolver MIB                July 93
  1067.  
  1068.  
  1069.                        DISABLED means that the cache is not being
  1070.                        used."
  1071.                ::= { dnsResCache 1 }
  1072.  
  1073.           dnsResCacheValid OBJECT-TYPE
  1074.                SYNTAX  DnsValid
  1075.                ACCESS  read-write
  1076.                STATUS  mandatory
  1077.                DESCRIPTION
  1078.                        "Setting this to CLEAR deletes the resolver's
  1079.                        entire cache."
  1080.                ::= { dnsResCache 2 }
  1081.  
  1082.           dnsResCacheMaxTTL OBJECT-TYPE
  1083.                SYNTAX  DnsTime
  1084.                ACCESS  read-write
  1085.                STATUS  mandatory
  1086.                DESCRIPTION
  1087.                        "Maximum Time-To-Live for RRs in this cache.
  1088.                        If the resolver does not implement a TTL
  1089.                        ceiling, the value of this field should be
  1090.                        hexadecimal FFFFFFFF."
  1091.                ::= { dnsResCache 3 }
  1092.  
  1093.           -- Resolver Cache Table
  1094.  
  1095.           -- The Resolver Cache Table contains information about
  1096.           -- Resource Records currently in the resolver's cache.
  1097.  
  1098.           dnsResCacheTable OBJECT-TYPE
  1099.                SYNTAX  SEQUENCE OF DnsResCacheEntry
  1100.                ACCESS  not-accessible
  1101.                STATUS  mandatory
  1102.                DESCRIPTION
  1103.                        "The entire contents of the resolver's cache."
  1104.               ::= { dnsResCache 4 }
  1105.  
  1106.           dnsResCacheEntry OBJECT-TYPE
  1107.                SYNTAX  DnsResCacheEntry
  1108.                ACCESS  not-accessible
  1109.                STATUS  mandatory
  1110.                DESCRIPTION
  1111.                        "A single entry in the resolvers's cache."
  1112.                INDEX { dnsResCacheName, dnsResCacheClass,
  1113.                        dnsResCacheType, dnsResCacheIndex  }
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.           Expires January 8, 1994                              [Page 19]
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.           draft                  DNS Resolver MIB                July 93
  1126.  
  1127.  
  1128.                ::= { dnsResCacheTable 1 }
  1129.  
  1130.           DnsResCacheEntry ::=
  1131.                SEQUENCE {
  1132.                    dnsResCacheName
  1133.                        DnsName,
  1134.                    dnsResCacheClass
  1135.                        DnsClass,
  1136.                    dnsResCacheType
  1137.                        DnsType,
  1138.                    dnsResCacheTTL
  1139.                        DnsTime,
  1140.                    dnsResCacheElapsedTTL
  1141.                        DnsTime,
  1142.                    dnsResCacheSource
  1143.                        IpAddress,
  1144.                    dnsResCacheRData
  1145.                        OCTET STRING,
  1146.                    dnsResCacheEntryValid
  1147.                        DnsValid,
  1148.                    dnsResCacheIndex
  1149.                        INTEGER
  1150.                }
  1151.           dnsResCacheName OBJECT-TYPE
  1152.                SYNTAX  DnsName  --  OCTET STRING
  1153.                ACCESS  read-only
  1154.                STATUS  mandatory
  1155.                DESCRIPTION
  1156.                        "Owner name of the Resource Record in the
  1157.                        cache which is identified in this row of the
  1158.                        table.  As described in RFC1034, the owner of
  1159.                        the record is the domain name were the RR is
  1160.                        found."
  1161.                ::= { dnsResCacheEntry 1 }
  1162.  
  1163.           dnsResCacheClass OBJECT-TYPE
  1164.                SYNTAX  DnsClass -- INTEGER (0..65535)
  1165.                ACCESS  read-only
  1166.                STATUS  mandatory
  1167.                DESCRIPTION
  1168.                        "DNS class of the Resource Record in the cache
  1169.                        which is identified in this row of the table."
  1170.                ::= { dnsResCacheEntry 2 }
  1171.  
  1172.           dnsResCacheType OBJECT-TYPE
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.           Expires January 8, 1994                              [Page 20]
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.           draft                  DNS Resolver MIB                July 93
  1185.  
  1186.  
  1187.                SYNTAX  DnsType -- INTEGER (0..65535)
  1188.                ACCESS  read-only
  1189.                STATUS  mandatory
  1190.                DESCRIPTION
  1191.                        "DNS type of the Resource Record in the cache
  1192.                        which is identified in this row of the table."
  1193.                ::= { dnsResCacheEntry 3 }
  1194.  
  1195.           dnsResCacheTTL OBJECT-TYPE
  1196.                SYNTAX  DnsTime
  1197.                ACCESS  read-only
  1198.                STATUS  mandatory
  1199.                DESCRIPTION
  1200.                        "Time-To-Live of RR in DNS cache.  This is the
  1201.                        initial TTL value which was received with the
  1202.                        RR when it was originally received."
  1203.                ::= { dnsResCacheEntry 4 }
  1204.  
  1205.           dnsResCacheElapsedTTL OBJECT-TYPE
  1206.                SYNTAX  DnsTime
  1207.                ACCESS  read-only
  1208.                STATUS  mandatory
  1209.                DESCRIPTION
  1210.                        "Elapsed seconds since RR was received."
  1211.                ::= { dnsResCacheEntry 5 }
  1212.  
  1213.           dnsResCacheSource OBJECT-TYPE
  1214.                SYNTAX  IpAddress
  1215.                ACCESS  read-only
  1216.                STATUS  mandatory
  1217.                DESCRIPTION
  1218.                        "Host from which RR was received, 0.0.0.0 if
  1219.                        unknown."
  1220.                ::= { dnsResCacheEntry 6 }
  1221.  
  1222.           dnsResCacheRData OBJECT-TYPE
  1223.                SYNTAX  OCTET STRING
  1224.                ACCESS  read-only
  1225.                STATUS  mandatory
  1226.                DESCRIPTION
  1227.                        "RDATA portion of a cached RR."
  1228.                ::= { dnsResCacheEntry 7 }
  1229.  
  1230.           dnsResCacheEntryValid OBJECT-TYPE
  1231.                SYNTAX  DnsValid
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.           Expires January 8, 1994                              [Page 21]
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.           draft                  DNS Resolver MIB                July 93
  1244.  
  1245.  
  1246.                ACCESS  read-write
  1247.                STATUS  mandatory
  1248.                DESCRIPTION
  1249.                        "Set to CLEAR to delete this RR entry from the
  1250.                        cache table."
  1251.                ::= { dnsResCacheEntry 8 }
  1252.  
  1253.           dnsResCacheIndex OBJECT-TYPE
  1254.                SYNTAX  INTEGER
  1255.                ACCESS  read-only
  1256.                STATUS  mandatory
  1257.                DESCRIPTION
  1258.                        "A value which makes entries in the table
  1259.                        unqiue when the other index values -
  1260.                        dnsResCacheName, dnsResCacheClass, and
  1261.                        dnsResCacheType do not provide uniqueness."
  1262.                ::= { dnsResCacheEntry 9 }
  1263.  
  1264.           -- Resolver Negative Cache Group
  1265.  
  1266.           -- The implementation of the Resolver Negative Cache group is
  1267.           -- mandatory for all systems which implement a negative
  1268.           -- cache function.
  1269.  
  1270.           dnsResNCacheStatus OBJECT-TYPE
  1271.                SYNTAX  INTEGER {
  1272.                     enabled (1),
  1273.                     disabled (2)
  1274.                }
  1275.                ACCESS  read-only
  1276.                STATUS  mandatory
  1277.                DESCRIPTION
  1278.                        "Status of the resolver's negative cache.
  1279.                        ENABLED means that the use of the negative
  1280.                        cache is allowed.
  1281.  
  1282.                        DISABLED means that the negative caching is
  1283.                        not being used."
  1284.                ::= { dnsResNCache 1 }
  1285.  
  1286.           dnsResNCacheValid OBJECT-TYPE
  1287.                SYNTAX  DnsValid
  1288.                ACCESS  read-write
  1289.                STATUS  mandatory
  1290.                DESCRIPTION
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.           Expires January 8, 1994                              [Page 22]
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.           draft                  DNS Resolver MIB                July 93
  1303.  
  1304.  
  1305.                        "Setting this to CLEAR deletes the resolver's
  1306.                        entire negative response cache."
  1307.                ::= { dnsResNCache 2 }
  1308.  
  1309.           dnsResNCacheMaxTTL OBJECT-TYPE
  1310.                SYNTAX  DnsTime
  1311.                ACCESS  read-write
  1312.                STATUS  mandatory
  1313.                DESCRIPTION
  1314.                        "Maximum Time-To-Live for cached authoritative
  1315.                        errors. If the resolver does not implement a
  1316.                        TTL ceiling, the value of this field should be
  1317.                        hexadecimal FFFFFFFF."
  1318.                ::= { dnsResNCache 3 }
  1319.  
  1320.           -- Resolver Negative Cache Table
  1321.  
  1322.           -- The Resolver Negative Cache Table contains information
  1323.           -- about authoritative errors that have been cached by the
  1324.           -- resolver.
  1325.  
  1326.           dnsResNCacheTable OBJECT-TYPE
  1327.                SYNTAX  SEQUENCE OF DnsResNCacheEntry
  1328.                ACCESS  not-accessible
  1329.                STATUS  mandatory
  1330.                DESCRIPTION
  1331.                        "The resolver's negative response cache."
  1332.                ::= { dnsResNCache 4 }
  1333.  
  1334.           dnsResNCacheEntry OBJECT-TYPE
  1335.                SYNTAX  DnsResNCacheEntry
  1336.                ACCESS  not-accessible
  1337.                STATUS  mandatory
  1338.                DESCRIPTION
  1339.                        "An entry in the resolver's negative response
  1340.                        cache."
  1341.                INDEX { dnsResNCacheErrQName, dnsResNCacheErrQClass,
  1342.                        dnsResNCacheErrQType, dnsResNCacheIndex  }
  1343.                ::= { dnsResNCacheTable 1 }
  1344.  
  1345.           DnsResNCacheEntry ::=
  1346.                SEQUENCE {
  1347.                    dnsResNCacheErrQName
  1348.                        DnsName,
  1349.                    dnsResNCacheErrQClass
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.           Expires January 8, 1994                              [Page 23]
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.           draft                  DNS Resolver MIB                July 93
  1362.  
  1363.  
  1364.                        DnsQClass,
  1365.                    dnsResNCacheErrQType
  1366.                        DnsQType,
  1367.                    dnsResNCacheErrTTL
  1368.                        DnsTime,
  1369.                    dnsResNCacheErrElapsedTTL
  1370.                        DnsTime,
  1371.                    dnsResNCacheErrSource
  1372.                        IpAddress,
  1373.                    dnsResNCacheErrCode
  1374.                        INTEGER,
  1375.                    dnsResNCacheErrValid
  1376.                        DnsValid,
  1377.                    dnsResNCacheIndex
  1378.                        INTEGER
  1379.                }
  1380.           dnsResNCacheErrQName OBJECT-TYPE
  1381.                SYNTAX  DnsName  --  OCTET STRING
  1382.                ACCESS  read-only
  1383.                STATUS  mandatory
  1384.                DESCRIPTION
  1385.                        "QNAME associated with a cached authoritative
  1386.                        error."
  1387.                ::= { dnsResNCacheEntry 1 }
  1388.  
  1389.           dnsResNCacheErrQClass OBJECT-TYPE
  1390.                SYNTAX  DnsQClass -- INTEGER (0..65535)
  1391.                ACCESS  read-only
  1392.                STATUS  mandatory
  1393.                DESCRIPTION
  1394.                       "DNS QCLASS associated with a cached
  1395.                       authoritative error."
  1396.                ::= { dnsResNCacheEntry 2 }
  1397.  
  1398.           dnsResNCacheErrQType OBJECT-TYPE
  1399.                SYNTAX  DnsQType -- INTEGER (0..65535)
  1400.                ACCESS  read-only
  1401.                STATUS  mandatory
  1402.                DESCRIPTION
  1403.                        "DNS QTYPE associated with a cached
  1404.                        authoritative error."
  1405.                ::= { dnsResNCacheEntry 3 }
  1406.  
  1407.           dnsResNCacheErrTTL OBJECT-TYPE
  1408.                SYNTAX  DnsTime
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.           Expires January 8, 1994                              [Page 24]
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.           draft                  DNS Resolver MIB                July 93
  1421.  
  1422.  
  1423.                ACCESS  read-only
  1424.                STATUS  mandatory
  1425.                DESCRIPTION
  1426.                        "Time-To-Live of a cached authoritative error
  1427.                        at the time of the error, it should not be
  1428.                        decremented by the number of seconds since it
  1429.                        was recieved. This should be the TTL as copied
  1430.                        from the MINIMUM field of the SOA that
  1431.                        accompanied the authoritative error."
  1432.                ::= { dnsResNCacheEntry 4 }
  1433.  
  1434.           dnsResNCacheErrElapsedTTL OBJECT-TYPE
  1435.                SYNTAX  DnsTime
  1436.                ACCESS  read-only
  1437.                STATUS  mandatory
  1438.                DESCRIPTION
  1439.                        "Elapsed seconds since authoritative error was
  1440.                        received."
  1441.                ::= { dnsResNCacheEntry 5 }
  1442.  
  1443.           dnsResNCacheErrSource OBJECT-TYPE
  1444.                SYNTAX  IpAddress
  1445.                ACCESS  read-only
  1446.                STATUS  mandatory
  1447.                DESCRIPTION
  1448.                        "Host which sent the authoritative error,
  1449.                        0.0.0.0 if unknown."
  1450.                ::= { dnsResNCacheEntry 6 }
  1451.  
  1452.           dnsResNCacheErrCode OBJECT-TYPE
  1453.                SYNTAX  INTEGER {
  1454.                    nonexistantName (1),
  1455.                    noData (2),
  1456.                    other (3)
  1457.                }
  1458.                ACCESS  read-only
  1459.                STATUS  mandatory
  1460.                DESCRIPTION
  1461.                       "The authoritative error that has been cached.
  1462.                       NonexistantName indicates an authoritative name
  1463.                       error.  NoData indicates an authoritative
  1464.                       response with no error and no relevant data."
  1465.                ::= { dnsResNCacheEntry 7 }
  1466.  
  1467.           dnsResNCacheErrValid OBJECT-TYPE
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.           Expires January 8, 1994                              [Page 25]
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.           draft                  DNS Resolver MIB                July 93
  1480.  
  1481.  
  1482.                SYNTAX  DnsValid
  1483.                ACCESS  read-write
  1484.                STATUS  mandatory
  1485.                DESCRIPTION
  1486.                       "Set to CLEAR to delete this cached error."
  1487.                ::= { dnsResNCacheEntry 8 }
  1488.  
  1489.           dnsResNCacheIndex OBJECT-TYPE
  1490.                SYNTAX  INTEGER
  1491.                ACCESS  read-only
  1492.                STATUS  mandatory
  1493.                DESCRIPTION
  1494.                        "A value which makes entries in the table
  1495.                        unique when the other index values -
  1496.                        dnsResNCacheErrQName, dnsResNCacheErrQClass,
  1497.                        and dnsResNCacheErrQType do not provide
  1498.                        uniqueness."
  1499.                ::= { dnsResNCacheEntry 9 }
  1500.  
  1501.           -- Resolver Statistics Group
  1502.  
  1503.           -- The implementation of the Resolver Statistics Group is
  1504.           -- mandatory for all resolver software implementations.
  1505.  
  1506.           dnsResStatGoodCaches OBJECT-TYPE
  1507.                SYNTAX  Counter
  1508.                ACCESS  read-only
  1509.                STATUS  mandatory
  1510.                DESCRIPTION
  1511.                        "Number of RRs the resolver has cached
  1512.                        successfully."
  1513.                ::= { dnsResStats 1 }
  1514.  
  1515.           dnsResStatBadCaches OBJECT-TYPE
  1516.                SYNTAX  Counter
  1517.                ACCESS  read-only
  1518.                STATUS  mandatory
  1519.                DESCRIPTION
  1520.                        "Number of RRs the resolver has refused to
  1521.                        cache because they appear to be dangerous or
  1522.                        irrelevant. E.g., RRs with suspiciously high
  1523.                        TTLs, unsolicited root information, or that
  1524.                        just don't appear to be relevant to the
  1525.                        question the resolver asked."
  1526.                ::= { dnsResStats 2 }
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.           Expires January 8, 1994                              [Page 26]
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.           draft                  DNS Resolver MIB                July 93
  1539.  
  1540.  
  1541.           dnsResStatGoodNCaches OBJECT-TYPE
  1542.                SYNTAX  Counter
  1543.                ACCESS  read-only
  1544.                STATUS  mandatory
  1545.                DESCRIPTION
  1546.                        "Number of authoritative errors the resolver
  1547.                        has cached successfully."
  1548.                ::= { dnsResStats 3 }
  1549.  
  1550.           dnsResStatBadNCaches OBJECT-TYPE
  1551.                SYNTAX  Counter
  1552.                ACCESS  read-only
  1553.                STATUS  mandatory
  1554.                DESCRIPTION
  1555.                        "Number of authoritative errors the resolver
  1556.                        would have liked to cache but was unable to
  1557.                        because the appropriate SOA RR was not
  1558.                        supplied or looked suspicious."
  1559.                ::= { dnsResStats 4 }
  1560.  
  1561.           -- Lame Delegation Table
  1562.  
  1563.           -- A lame delegation occurs when a parent zone delagates
  1564.           -- authority for a child zone to a server that appears not to
  1565.           -- think that it is authoritative for the child zone in
  1566.           -- question.
  1567.  
  1568.           dnsResLameDelegationTable OBJECT-TYPE
  1569.                SYNTAX  SEQUENCE OF DnsResLameDelegationEntry
  1570.                ACCESS  not-accessible
  1571.                STATUS  mandatory
  1572.                DESCRIPTION
  1573.                       "Table of name servers returning lame
  1574.                       delegations."
  1575.                ::= { dnsResStats 5 }
  1576.  
  1577.           dnsResLameDelegationEntry OBJECT-TYPE
  1578.                SYNTAX  DnsResLameDelegationEntry
  1579.                ACCESS  not-accessible
  1580.                STATUS  mandatory
  1581.                DESCRIPTION
  1582.                    "Entry in lame delegation table."
  1583.                INDEX { dnsResLameDelegationSource,
  1584.                        dnsResLameDelegationName,
  1585.                        dnsResLameDelegationClass }
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.           Expires January 8, 1994                              [Page 27]
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.           draft                  DNS Resolver MIB                July 93
  1598.  
  1599.  
  1600.                ::= { dnsResLameDelegationTable 1 }
  1601.  
  1602.           DnsResLameDelegationEntry ::=
  1603.                SEQUENCE {
  1604.                    dnsResLameDelegationSource
  1605.                        IpAddress,
  1606.                    dnsResLameDelegationName
  1607.                        DnsName,
  1608.                    dnsResLameDelegationClass
  1609.                        DnsClass,
  1610.                    dnsResLameDelegationCounts
  1611.                        Counter,
  1612.                    dnsResLameDelegationValid
  1613.                        DnsValid
  1614.                }
  1615.           dnsResLameDelegationSource OBJECT-TYPE
  1616.                SYNTAX  IpAddress
  1617.                ACCESS  read-only
  1618.                STATUS  mandatory
  1619.                DESCRIPTION
  1620.                        "Source of lame delegation."
  1621.                ::= { dnsResLameDelegationEntry 1 }
  1622.  
  1623.           dnsResLameDelegationName OBJECT-TYPE
  1624.                SYNTAX  DnsName
  1625.                ACCESS  read-only
  1626.                STATUS  mandatory
  1627.                DESCRIPTION
  1628.                        "DNS name for which lame delegation was
  1629.                        received."
  1630.                ::= { dnsResLameDelegationEntry 2 }
  1631.  
  1632.           dnsResLameDelegationClass OBJECT-TYPE
  1633.                SYNTAX  DnsClass -- INTEGER (0..65535)
  1634.                ACCESS  read-only
  1635.                STATUS  mandatory
  1636.                DESCRIPTION
  1637.                        "DNS class of received lame delegation."
  1638.                ::= { dnsResLameDelegationEntry 3 }
  1639.  
  1640.           dnsResLameDelegationCounts OBJECT-TYPE
  1641.                SYNTAX  Counter
  1642.                ACCESS  read-only
  1643.                STATUS  mandatory
  1644.                DESCRIPTION
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.           Expires January 8, 1994                              [Page 28]
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.           draft                  DNS Resolver MIB                July 93
  1657.  
  1658.  
  1659.                        "How many times this lame delegation has been
  1660.                        received."
  1661.                ::= { dnsResLameDelegationEntry 4 }
  1662.  
  1663.           dnsResLameDelegationValid OBJECT-TYPE
  1664.                SYNTAX  DnsValid
  1665.                ACCESS  read-write
  1666.                STATUS  mandatory
  1667.                DESCRIPTION
  1668.                       "Set to CLEAR to delete this lame delegation
  1669.                       entry."
  1670.                ::= { dnsResLameDelegationEntry 5 }
  1671.  
  1672.           -- Resolver Optional Counters Group
  1673.  
  1674.           -- Implementation of the Resolver Optional counters group
  1675.           -- is optional.
  1676.  
  1677.           dnsResOptCounterReferals OBJECT-TYPE
  1678.                SYNTAX  Counter
  1679.                ACCESS  read-only
  1680.                STATUS  mandatory
  1681.                DESCRIPTION
  1682.                        "Number of responses which were received from
  1683.                        servers redirecting query to another server."
  1684.                ::= { dnsResOptCounter 1 }
  1685.  
  1686.           dnsResOptCounterRetrans OBJECT-TYPE
  1687.                SYNTAX  Counter
  1688.                ACCESS  read-only
  1689.                STATUS  mandatory
  1690.                DESCRIPTION
  1691.                        "Number requests retransmitted for all reasons."
  1692.                ::= { dnsResOptCounter 2 }
  1693.  
  1694.           dnsResOptCounterNoResponses OBJECT-TYPE
  1695.                SYNTAX  Counter
  1696.                ACCESS  read-only
  1697.                STATUS  mandatory
  1698.                DESCRIPTION
  1699.                        "Number of queries that were retransmitted
  1700.                        because of no response."
  1701.                ::= { dnsResOptCounter 3 }
  1702.  
  1703.           dnsResOptCounterRootRetrans OBJECT-TYPE
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.           Expires January 8, 1994                              [Page 29]
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.           draft                  DNS Resolver MIB                July 93
  1716.  
  1717.  
  1718.                SYNTAX  Counter
  1719.                ACCESS  read-only
  1720.                STATUS  mandatory
  1721.                DESCRIPTION
  1722.                        "Number of queries that were retransmitted
  1723.                        that were to root servers."
  1724.                ::= { dnsResOptCounter 4 }
  1725.  
  1726.           dnsResOptCounterInternals OBJECT-TYPE
  1727.                SYNTAX  Counter
  1728.                ACCESS  read-only
  1729.                STATUS  mandatory
  1730.                DESCRIPTION
  1731.                        "Number of requests internally generated by
  1732.                        the resolver."
  1733.                ::= { dnsResOptCounter 5 }
  1734.  
  1735.           dnsResOptCounterInternalTimeOuts OBJECT-TYPE
  1736.                SYNTAX  Counter
  1737.                ACCESS  read-only
  1738.                STATUS  mandatory
  1739.                DESCRIPTION
  1740.                        "Number of requests internally generated which
  1741.                        timed out."
  1742.                ::= { dnsResOptCounter 6 }
  1743.  
  1744.           END
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.           Expires January 8, 1994                              [Page 30]
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.           draft                  DNS Resolver MIB                July 93
  1775.  
  1776.  
  1777.           7.  Acknowledgements
  1778.  
  1779.           This document is the result of work undertaken the by DNS
  1780.           working group.  In addition, the contributions and comments of
  1781.           the following members are also specially acknowledged:
  1782.  
  1783.                Philip Almquist, Computer Communication consultant
  1784.  
  1785.                Joe Peck, Digital Equipment Corporation
  1786.  
  1787.                Frank Kastenholz, FTP Software
  1788.  
  1789.                Win Treese, Digital Equipment Corporation
  1790.  
  1791.                Mimi Zohar, IBM
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.           Expires January 8, 1994                              [Page 31]
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.           draft                  DNS Resolver MIB                July 93
  1834.  
  1835.  
  1836.           8.  References
  1837.  
  1838.                J. Reynolds and J. Postel, Assigned Numbers. Internet
  1839.                Working Group Request for Comments 1010.  Network
  1840.                Information Center, SRI International, Menlo Park,
  1841.                California, (May, 1987).
  1842.  
  1843.                M. Stahl, Domain Administrators Guide.  Internet Working
  1844.                Group Request for Comments 1032. Network Information
  1845.                Center, SRI International, Menlo Park, California,
  1846.                (November, 1987).
  1847.  
  1848.                M. Lottor, Domain Administrators Operations Guide,
  1849.                Internet Working Group Request for Comments 1033. Network
  1850.                Information Center, SRI International, Menlo Park,
  1851.                California, (November, 1987).
  1852.  
  1853.                P. Mockapetris, Domain Names - Concepts and Facilities,
  1854.                Internet Working Group Request for Comments 1034. Network
  1855.                Information Center, SRI International, Menlo Park,
  1856.                California, (November, 1987).
  1857.  
  1858.                P. Mockapetris, Domain Names - Implementation and
  1859.                Specification, Internet Working Group Request for
  1860.                Comments 1035. Network Information Center, SRI
  1861.                International, Menlo Park, California, (November, 1987).
  1862.  
  1863.                V. Cerf, IAB Recommendations for the Development of
  1864.                Internet Network Management Standards. Internet Working
  1865.                Group Request for Comments 1052. Network Information
  1866.                Center, SRI International, Menlo Park, California,
  1867.                (April, 1988).
  1868.  
  1869.                R. Braden (editor) Requirements for Internet Hosts --
  1870.                Application and Support, Internet Working Group Request
  1871.                for Comments 1123. Network Information Center, SRI
  1872.                International,Menlo Park, California, (October, 1989).
  1873.  
  1874.                M.T. Rose and K. McCloghrie, Structure and Identification
  1875.                of Management Information for TCP/IP-based internets,
  1876.                Internet Working Group Request for Comments 1155. Network
  1877.                Information Center, SRI International, Menlo Park,
  1878.                California, (May, 1990).
  1879.  
  1880.                K. McCloghrie and M.T. Rose, Management Information Base
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.           Expires January 8, 1994                              [Page 32]
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.           draft                  DNS Resolver MIB                July 93
  1893.  
  1894.  
  1895.                for Network Management of TCP/IP-based internets,
  1896.                Internet Working Group Request for Comments 1156, Network
  1897.                Information Center, SRI International, Menlo Park,
  1898.                California, (May, 1990).
  1899.  
  1900.                J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin,
  1901.                Simple Network Management Protocol, Internet Working
  1902.                Group Request for Comments 1157. Network Information
  1903.                Center, SRI International, Menlo Park, California, (May,
  1904.                1990).
  1905.  
  1906.                M.T. Rose, The Open Book, A Practical Perspective on OSI.
  1907.                Prentice Hall, Englewood Cliffs, New Jersey, (1990).
  1908.  
  1909.                M.T. Rose and K. McCloghrie (editors) Concise MIB
  1910.                Definitions, Internet Working Group Request for Comments
  1911.                1212, Network Information Center, SRI International,
  1912.                Menlo Park, California, (March, 1991).
  1913.  
  1914.                K. McCloghrie and M.T. Rose (editors), Management
  1915.                Information Base for Network Management of TCP/IP-based
  1916.                internets: MIB-II, Internet Working Group Request for
  1917.                Comments 1213. Network Information Center, SRI
  1918.                International, Menlo Park, California, (March, 1991).
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.           Expires January 8, 1994                              [Page 33]
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.           draft                  DNS Resolver MIB                July 93
  1952.  
  1953.  
  1954.           9.  Security Considerations
  1955.  
  1956.           Security issues are not discussed in this memo.
  1957.  
  1958.  
  1959.           10.  Author's Addresses
  1960.  
  1961.  
  1962.                Rob Austein
  1963.                Epilogue Technology Corporation
  1964.                268 Main Street, Suite 283
  1965.                North Reading, MA 01864
  1966.                USA
  1967.  
  1968.                Voice: +1 617 942 0915
  1969.                Email: sra@epilogue.com
  1970.  
  1971.  
  1972.                Jon Saperia
  1973.                Digital Equipment Corporation
  1974.                153 Taylor Street
  1975.                M/S TAY2-2/B5
  1976.                Littleton, MA 01460
  1977.  
  1978.                Voice: +1 508-952-3171
  1979.                Email: saperia@tay.dec.com
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.           Expires January 8, 1994                              [Page 34]
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.           draft                  DNS Resolver MIB                July 93
  2011.  
  2012.  
  2013.           Table of Contents
  2014.  
  2015.  
  2016.           1 Introduction ..........................................    3
  2017.           2 The Network Management Framework ......................    4
  2018.           2.1 Object Definitions ..................................    4
  2019.           2.2 Format of Definitions ...............................    4
  2020.           3 Overview ..............................................    5
  2021.           4 Selected Objects ......................................    7
  2022.           5 Textual Conventions ...................................    8
  2023.           6 Definitions ...........................................    9
  2024.           7 Acknowledgements ......................................   31
  2025.           8 References ............................................   32
  2026.           9 Security Considerations ...............................   34
  2027.           10 Author's Addresses ...................................   34
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.           Expires January 8, 1994                              [Page 35]
  2064.  
  2065.